home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / comm / 140xpcom.zip / XPCOM140.CMP / XPCOM14 / DOCS / SECTION.002 < prev    next >
Text File  |  1993-11-20  |  17KB  |  374 lines
  1.                          XPCOM Version 1.4                Page : 2-1
  2.  
  3.  
  4.      Keyboard / Mouse
  5.  
  6.      XPCOM supports both mouse and keyboard user interface..
  7.  
  8.      Keyboard Entry
  9.  
  10.      After loading, the program will be loaded with the default
  11.      parameters from the last time the program was run. To activate the
  12.      Main Menu, all that is required is to press the F10 function key.
  13.      At this point the top menu bar will be displayed.
  14.  
  15.      Each entry in the top menu bar has an associated 'Hot Key' . The
  16.      Hot Key is designed in red. By pressing the hot key the user will
  17.      be taken to that item. To activate the current menu item all that
  18.      is needed is to press the return key. This will display the menu
  19.      options. The menu options also are HOT KEYED allowing for rapid
  20.      user interface.
  21.  
  22.      The cursor and tab keys are active during keyboard input, allowing
  23.      the user to easily move from option to option.
  24.  
  25.      When the user is entering a text string it will first be necessary
  26.      to press the return / enter key to activate the item. An example of
  27.      this entry form can be found under the AMTOR SELCAL and ARQ modes.
  28.      To complete the entry the user should press enter.
  29.  
  30.      During all operations the ESC key may be used to cancel the current
  31.      event. If the event is the Main Menu bar the program will return to
  32.      normal operation.
  33.  
  34.      Mouse Input
  35.  
  36.      A mouse (not required) may be used for over 95% of all program
  37.      operations. To bring up the Main menu, place mouse cursor on top
  38.      line and press one of the mouse buttons momentarily. To exit the
  39.      menu, press the mouse button when the mouse cursor is located
  40.      outside the active menu area.
  41.  
  42.      General Program Information
  43.  
  44.      This section is intended to give the user an overview of the
  45.      various components of XPCOM.
  46.  
  47.      Main Screen
  48.  
  49.       The main screen consists of three individual components. These are
  50.  
  51.                 Receive Window
  52.                 Transmit Window
  53.                 Status Window (used as dividers at top, middle and
  54.                                bottom of the screen)
  55.                          XPCOM Version 1.4                Page : 2-2
  56.  
  57.     All window attributes are user definable, including background
  58.     color, text color and border types (XP Windows). See color setup for
  59.     more information, this is located in the Setup menu option.
  60.  
  61.      Receive Window
  62.  
  63.     The receive window is used for displaying the incoming text in all
  64.     modes, except the AEA Host mode Packet operation. During Host mode
  65.     Packet operation the receive window is used as the Monitor window
  66.     allowing the user to view channel traffic separately from connected
  67.     traffic. If Dual TNC operation is selected the window will be split
  68.     with a dividing bar. If you wish to change the size of the
  69.     individual windows place the mouse on the center bar, hold the left
  70.     mouse button, and move the window to the desired position.
  71.  
  72.      Transmit Window
  73.  
  74.     The transmit window shows the outgoing text from the user. The text
  75.     is sent to the TNC based on the setting of WORDOUT and LINEOUT. See
  76.     TNC Parameters section for a detailed description of Lineout and
  77.     Wordout.
  78.  
  79.     During AEA Host packet operation a separate transmit window is
  80.     established for each stream. This allows the user to type a command
  81.     (without carriage return) switch to a different stream send a packet
  82.     then come back to the original stream and hit the return key to send
  83.     the packet.
  84.  
  85.      Status Window
  86.  
  87.     The status window is used to provide information to the user on :
  88.  
  89.           Operating Mode
  90.           Baud Rates
  91.           Unacknowledged Packet    (Host Mode)
  92.           AMTOR Status             (Host Mode)
  93.           Free Memory
  94.           Date                     Toggles between Local and UTC
  95.           Time                     Toggles between Local and UTC
  96.           Connect Status
  97.  
  98.     Various sections of the status window change during operation of
  99.     XPCOM. This is normal and will give information that is pertinent to
  100.     the current mode of operation.
  101.  
  102.     The status windows are also used as mouse control. Example, the
  103.     above window has RxN, TxN, Mon On, and Host shown in the Status
  104.     window. If user wishes to switch the AEA command mode, he only has
  105.     to click the mouse on the word 'Host'. To transmit a file, click on
  106.     the TxN button, once the file transfer has started the button will
  107.     flash, to abort the transfer simply click on the flashing 'TxY'.
  108.                          XPCOM Version 1.4                Page : 2-3
  109.  
  110.     Log Book Operation
  111.  
  112.     XPCOM offers an extremely powerful log book function. If selected,
  113.     the log book is automatically searched in Packet operation allowing
  114.     the user to know immediately if a station has been previously
  115.     worked. In addition all log book data my be called by using the
  116.     built-in Macro Commands. The macro commands are covered in the next
  117.     section.
  118.  
  119.     Entering a Call Sign
  120.  
  121.     In all modes except for Packet it is necessary to enter the call
  122.     sign of the station being worked. To enter the call press the 'F2'
  123.     key. A dialog will appear as shown below.
  124.  
  125.                         ╔═════════════════════╗
  126.                         ║ Other Stations Call ║
  127.                         ║                     ║
  128.                         ║   AH6KM_________    ║
  129.                         ╚═════════════════════╝
  130.  
  131.                 Be sure to hit the Enter key, if the ESC is pressed the
  132.                 operation will be aborted.
  133.  
  134.                 After the call is entered the log book will be searched,
  135.                 the user can control the searching of the log. The
  136.                 Auto Search feature may be activated in the Operating
  137.                 Parameters Menu, This is located in the Main menu under
  138.                 Setup.
  139.  
  140.                 If the call sign is found a small Mini-Log will be
  141.                 displayed (if activated under operating parameters).
  142.                 This box will contain the Station Call, Operators Name,
  143.                 QTH and the last date/time he was worked. Also the
  144.                 following data is carried over to the new log entry,
  145.                 Name, QTH and comments. This makes it easy to review
  146.                 other stations data. The Mini-Log is shown below. The
  147.                 Mini-Log may be toggled on/off at any time by pressing
  148.                 the Alt-F4 key.
  149.  
  150.                         ╔═══════════════════════════╗
  151.                         ║ AH6KM                     ║
  152.                         ║ Gary                      ║
  153.                         ║ Dixon, California         ║
  154.                         ║ Last QSO  07:12  12/29/92 ║
  155.                         ╚═══════════════════════════╝
  156.                                XPCOM Mini Log
  157.  
  158.                 If the station is not found, the box will appear showing
  159.                 only the call sign of the station.
  160.  
  161.                          XPCOM Version 1.4                Page : 2-4
  162.  
  163.                 Example
  164.                         ╔═══════════════════════════╗
  165.                         ║ AH6KM                     ║
  166.                         ║                           ║
  167.                         ║                           ║
  168.                         ║ Last QSO    :      /  /   ║
  169.                         ╚═══════════════════════════╝
  170.  
  171.         Entering Data into the Log
  172.  
  173.                 The first method is probably the easiest to use in a
  174.                 conversation. This involves using three special keys
  175.                 that are available.
  176.  
  177.                 Entering the Other Operators Name (Ctrl-N)
  178.  
  179.                         To enter the other stations name press the
  180.                         CTRL-N key. This will pull up a small dialog box
  181.                         in the outgoing text window similar to below.
  182.  
  183.                         ╔══════════════════════════════╗
  184.                         ║                              ║
  185.                         ║ Name ________________________║
  186.                         ╚══════════════════════════════╝
  187.  
  188.                         Enter the name and be sure to press the enter
  189.                         key. After this has been done the name will
  190.                         appear in the Minilog as well as the main log
  191.                         screen (more on that later).
  192.  
  193.                 Entering the Frequency (Ctrl-F)
  194.  
  195.                         To enter the frequency press the Ctrl-F key
  196.                         sequence. this will bring up another dialog box.
  197.                         Enter the complete frequency. XPCOM keeps the
  198.                         frequency in HERTZ. So be sure to enter the full
  199.                         frequency. This is done to ensure compatibility
  200.                         for radio control modules that are currently
  201.                         being developed. XPCOM handles frequency up to
  202.                         999,999.99 Hz.  If you have an interfaced radio
  203.                         this will be done automatically.
  204.  
  205.                 Entering the QTH  (Ctrl-Q)
  206.  
  207.                         The other station QTH may be entered by pressing
  208.                         the CTRL-Q sequence. Enter the QTH and press
  209.                         return.
  210.                          XPCOM Version 1.4                Page : 2-5
  211.  
  212.         Using the Main Log Screen  (F3)
  213.  
  214.                 The user may invoke the main log screen by pressing the
  215.                 F3 key.
  216.  
  217.  
  218.                 The log screen is auto-indexing, meaning that it will
  219.                 tab to the first blank field each time F3 is pressed.
  220.  
  221.                 The following items are set automatically by XPCOM, call
  222.                 sign (if entered via F2), the Selcal (calculated from
  223.                 F2), time, date, default Tx/Rx RST values, operating,
  224.                 and the operator information if found from a previous
  225.                 QSO. Any defaults may be changed by tabbing to the
  226.                 field, entering the data and pressing the Enter key.
  227.  
  228.  
  229.                 Under normal operating it is only necessary to access F3
  230.                 when you wish to add comments.  The comments field is
  231.                 limited to 100 characters.
  232.  
  233.         Reviewing Log Data
  234.  
  235.  
  236.                 To review the data just toggle the F3 key. This allows
  237.                 the log to easily be moved on and off the screen.
  238.  
  239.         Saving the Current Log Entry to Disk
  240.  
  241.                 To save a log entry two methods are available. The first
  242.                 method is to tab to the Save button in the Log screen.
  243.                 The second method is to press Ctrl-L. A short delay may
  244.                 be noticed as the index file is updated.
  245.  
  246.         Log Operation in Packet Mode (PK-232)
  247.  
  248.                 The log operation in packet is slightly different. Upon
  249.                 a connect the stations call is searched (if Auto Search
  250.                 is on) and the Name and QTH data will be displayed
  251.                 across the top of the connect window.
  252.  
  253.                 Each packet stream carries its own log entry. To a log
  254.                 entry.
  255.  
  256.                         1.      Move to the stream. (See packet operation)
  257.                         2.      Press the F3 key.
  258.  
  259.                         Note    The F3 key is active only on connected
  260.                                 streams.
  261.  
  262.                 If the Auto Save feature is selected, the log entry for
  263.                 a stream is automatically saved when the disconnect
  264.                 occurs. This greatly simplifies log operation in Packet
  265.                 Mode.
  266.                          XPCOM Version 1.4                Page : 2-6
  267.  
  268.         Text Macros
  269.  
  270.         XPCOM allows the user to tailor his output as he sees fit. The
  271.         Macro substitution commands allow placing special characters in
  272.         the outgoing text to "personalize" the transmission. These
  273.         commands may be used in the End Key Text, Drop Link Text, Brag
  274.         Text, Brag Files and any other text files the user wishes to
  275.         create.
  276.  
  277.         The user may also call other brag files or text from within a
  278.         brag file or brag text line. Beware, do not call the SAME brag
  279.         file or brag text line within one command. This can and WILL
  280.         cause the program to lock up.
  281.  
  282.         Note the extensive use of the Macro commands in the Operating
  283.         parameters menu.
  284.  
  285.         Macro Commands
  286.  
  287.         Your Station Information   ~sc     Your station call
  288.                                    ~ss     Your station SELCAL
  289.                                    ~sq     Your station QTH
  290.                                    ~sn     Your name
  291.                                    ~sr     Your received signal report
  292.  
  293.         Other Stations Information ~hc     Other stations call
  294.                                    ~hs     Other stations SELCAL
  295.                                    ~hq     Other stations QTH
  296.                                    ~hn     Other stations name
  297.                                    ~hr     Other stations signal report
  298.  
  299.         Additional Commands        ~bt#    Appends brag text line.
  300.                                            This is equivalent to
  301.                                            typing Alt-#.  Where
  302.                                            # is a number from 0 to 9.
  303.  
  304.                                    ~bf#    Appends brag file.  This is
  305.                                            equivalent to typing Ctrl-F#.
  306.                                            Where # is a number from 0
  307.                                            to 9.
  308.  
  309.                                    ~du     Appends current date (UTC).
  310.                                    ~dl     Appends current date (Local).
  311.                                    ~tu     Appends current time (UTC)
  312.                                    ~tl     Appends current time (Local)
  313.  
  314.                          XPCOM Version 1.4                Page : 2-7
  315.  
  316.                                    ~f      Appends current frequency
  317.                                            from the log book.
  318.  
  319.                                    ~ld     Last date station was worked.
  320.                                            (only valid if Auto Search is
  321.                                             enabled)
  322.                                    ~lt     Last time station was worked.
  323.                                            (only valid if Auto Search is
  324.                                             enabled)
  325.  
  326.                                    ~m      Appends current operating mode.
  327.  
  328.                                    ~r      Adds a carriage return to
  329.                                            the outgoing test. Very
  330.                                            handy command for splitting
  331.                                            up lines of text.
  332.  
  333.         All text substitution commands get their input from the
  334.         information contained in the log screen. In other words you must
  335.         first fill out the log book before using any of the ~hx
  336.         commands. The parameter ~sr is also taken from the log book.
  337.         Commands may be in either upper or lower case.
  338.  
  339.         Examples using Macro Substitution Commands
  340.  
  341.                 The following is used in all examples :
  342.  
  343.                 Your call               -> KF7XP
  344.                 Other stations call     -> W0ABC
  345.                 Time                    -> 15:35 UTC
  346.                 Date                    -> October 19, 1992
  347.                 Your QTH                -> Mesa, Arizona
  348.                 Other Stations QTH      -> Omaha, Nebraska
  349.                 Your Name               -> Gary
  350.                 Other Stations Name     -> Joe
  351.  
  352.         Ex 1    End Key Text for AMTOR
  353.  
  354.                 Command Line from Operating Parameters Menu
  355.  
  356.                            ~hc DE ~sc +?
  357.  
  358.                 Would be sent as
  359.  
  360.                            W0ABC DE KF7XP +?
  361.                          XPCOM Version 1.4                Page : 2-8
  362.  
  363.         Ex 2    Brag Text
  364.                            Brag Text 1 -> Thanks ~hn for ~sr from ~hq~r~bt2
  365.                            Brag Text 2 ->  QTH here is ~sq and name is ~sn.
  366.  
  367.                 Would be sent as
  368.  
  369.                            Thanks Joe for 599 from Omaha, Nebraska
  370.                            QTH here is Mesa, Arizona and name is Gary.
  371.  
  372.                 Note QTH information is sent on next line.  Also
  373.                 don't leave a space after a carriage return (~r).
  374.